home *** CD-ROM | disk | FTP | other *** search
/ The Arsenal Files 1 / The Arsenal Files (Arsenal Computer).ISO / novell / ngm176.exe / NGM176.TXT next >
Text File  |  1993-12-06  |  16KB  |  407 lines
  1.  
  2.               NOVELL TECHNICAL INFORMATION DOCUMENT
  3.  
  4. TITLE:              SNADS Unlimited-User Upgrade v1.0 B to v1.0 C
  5. DOCUMENT ID:        TID200026
  6. DOCUMENT REVISION:  A
  7. DATE:               06DEC93
  8. ALERT STATUS:       Yellow
  9. INFORMATION TYPE:   Symptom Solution
  10. README FOR:         NGM176.EXE
  11.  
  12. NOVELL PRODUCT and VERSION:
  13. SNADS for NetWare Global MHS
  14.  
  15. ABSTRACT:
  16.  
  17. This patch program will upgrade your NGMSNADS unlimited-user version 1.0 revB
  18. to version 1.0 revC.  This patch program replaces the SNADSL2 and SNADSL3
  19. patches and will upgrade these patched versions of NGMSNADS v1.0 revC to the
  20. latest revC level.
  21.  
  22. ──────────────────────────────────────────────────────────────────────────────
  23. DISCLAIMER
  24. THE ORIGIN OF THIS INFORMATION MAY BE INTERNAL OR EXTERNAL TO NOVELL.  NOVELL
  25. MAKES EVERY EFFORT WITHIN ITS MEANS TO VERIFY THIS INFORMATION.  HOWEVER, THE
  26. INFORMATION PROVIDED IN THIS DOCUMENT IS FOR YOUR INFORMATION ONLY.  NOVELL
  27. MAKES NO EXPLICIT OR IMPLIED CLAIMS TO THE VALIDITY OF THIS INFORMATION.
  28. ──────────────────────────────────────────────────────────────────────────────
  29.  
  30. ADDITIONAL CONFIGURATION
  31.  
  32.      Before installing this patch, you must be running NetWare Global MHS
  33.      v2.00b or a subsequent version.  If you have NetWare for Global Messaging
  34.      v1.0 or NetWare Global MHS v2.00, you can obtain the patch for v2.00b
  35.      from any of the following sources:
  36.  
  37.           *    NetWire 
  38.  
  39.           *    by sending a message to library@novell with subject: guide
  40.  
  41.           *    Novell Technical Support
  42.  
  43.  
  44. SYMPTOM
  45.  
  46.      SNADS Update needed
  47.  
  48. TROUBLESHOOTING
  49.  
  50.      Troubleshooting Hints
  51.      =====================
  52.  
  53.      For detailed troubleshooting instructions, refer to Chapter 8 of the
  54.      NetWare Global Messaging SNADS Protocol Module Administrator's Guide.
  55.      Following are suggestions for troubleshooting common problems.
  56.  
  57.  
  58.      Problem:
  59.      Messages from SNADS are remaining in the NGM queue, with the following
  60.      workgroup name:
  61.           -unauthorized-.workgroup
  62.  
  63.      Action:
  64.      This error occurs if you are using a limited-user version of the SNADS
  65.      protocol module. The NetWare Global MHS recipient is not defined as an
  66.      authorized user. Add the user to the list of authorized users, following
  67.      the instructions in Chapter 6 of the guide.
  68.  
  69.  
  70.      Problem:
  71.      The SNADS node is rejecting messages received from the SNADS protocol
  72.      module.
  73.  
  74.      Action:
  75.      Check the maximum number of recipients for which your SNADS node is
  76.      configured. If it is less than 256, add the following parameter to the
  77.      [NGMSNADS] section of your server's NGM.CFG file:
  78.  
  79.           Maximum-Recipients=<nnn>
  80.  
  81.      where <nnn> is the maximum number of recipients your SNADS node will
  82.      accept. For more information about NGM.CFG, refer to Appendix B of the
  83.      guide.
  84.  
  85.  
  86.      Problem:
  87.      Global MHS users are receiving non-delivery notifications that contain no
  88.      explanation of the reason for non-delivery.
  89.  
  90.      Action:
  91.      a.   If you are using a limited-user version of SNADS for Global MHS,    
  92.           make sure the sender has been authorized to send messages to SNADS. 
  93.           Refer to chapter 6 of the "NetWare Global Messaging SNADS Protocol
  94.           Module Administrator's Guide" for detailed instructions.
  95.  
  96.      b.   Check for communication problems.  This error occurs if there is an
  97.           unrecoverable communication error while SNADS for Global MHS is
  98.           transmitting a message to the SNADS node.
  99.  
  100.  
  101.      Problem:
  102.      Messages from SNADS are arriving at their destination in binary format. 
  103.      The destination server does not connect to SNADS directly, but through an
  104.      intermediate server.
  105.  
  106.      Action:
  107.      a.   (Recommended solution) In the SNADS directory, do not define servers
  108.           that connect to SNADS indirectly.  Instead, define their DGNs as
  109.           belonging to the server that does connect directly.  For example,
  110.           Server1 connects to SNADS directly; Server2 communicates with SNADS
  111.           through Server1.  Server2 has two workgroups, Personnel (SNADS
  112.           alias=PERSONNE) and Finance (SNADS alias=FINANCE).  In the SNADS
  113.           directory, PERSONNE and FINANCE are defined as DGNs at Server1.
  114.  
  115.      b.   If you prefer to define indirectly-connected servers in the SNADS
  116.           directory, ensure that the SNADS alias for the directly-connecting
  117.           server contains the aliases for all servers to which it routes
  118.           messages received from SNADS.  For example, if  Server2 (RGN=ACME,
  119.           REN=SERVER2) is defined in the SNADS directory, you must define the
  120.           following SNADS alias for Server1 (RGN=ACME, REN=SERVER1):
  121.  
  122.           ACME.SERVER1,ACME.SERVER2
  123.  
  124.  
  125.  
  126.      Problem:
  127.      Directory information received from DISOSS is not being integrated into
  128.      the Global MHS database.
  129.  
  130.      Action:
  131.      Ensure that your Global MHS server subscribes to the DISOSS workgroups.
  132.      For more information, refer to Chapter 7 of the guide.
  133.  
  134.  
  135.      General Information
  136.      ===================
  137.  
  138.      This section provides additional information about the SNADS protocol
  139.      module.
  140.  
  141.           *    If a session terminates while the SNADS protocol module is
  142.                delivering a message to SNADS, the SNADS protocol module will
  143.                resend the message during the next session. If the message was
  144.                delivered successfully before the termination occurred, two
  145.                copies of the message might be delivered to the SNADS
  146.                recipient.
  147.  
  148.           *    When a DISOSS user sends a message to a NetWare Global MHS
  149.                distribution list, DISOSS receives a DIA status (delivery
  150.                report) from each of the list members. Since the list member
  151.                names do not match the original recipient name (the
  152.                distribution list), the message status is not updated.
  153.  
  154.      For example, a DISOSS user sends a message to a NetWare Global MHS list
  155.      called "Managers." NetWare Global MHS distributes the message to John
  156.      Smith and Mary Adams, the  list members. DISOSS receives DIA statuses
  157.      from John and Mary, but it does not receive one from "Managers," the
  158.      original recipient. Therefore, it does not update the message status.
  159.  
  160.           *    SMF short names can only include letters, numbers, and the
  161.                following special characters: #, $, and -. To ensure
  162.                compatibility between SNADS and NetWare Global MHS, do not use
  163.                unsupported characters (such as spaces) in SNADS names.
  164.  
  165.           *    If you are using DISOSS Directory Synchronization, workgroups
  166.                in your organization must not include both DISOSS and NetWare
  167.                Global MHS users.
  168.  
  169.           *    SNADS for Global MHS cannot detect the Keyword document
  170.                translation program (DOCXLT) when it is auto-loaded by NGM.  If
  171.                document translations are not being invoked,  unload DOCXLT and
  172.                reload it manually.
  173.  
  174.           *    The Keyword document translation program (DOCXLT) has an
  175.                auto-detection feature that allows it to determine a document
  176.                type.  However, this feature might identify a binary file as
  177.                type TEXT, and attempt to convert it.  This results in
  178.                corruption of the file.
  179.  
  180.  
  181. SOLUTION
  182.  
  183.      Apply NGM176.EXE
  184.  
  185.  
  186.      Self-Extracting File Name:  NGM176.EXE     Revision:  A
  187.  
  188.      Files Included    Size      Date      Time
  189.  
  190.      \
  191.        NGM176.TXT             (This File)
  192.       RELNOTE.TXT      18628   10-18-93    9:52a
  193.         PATCH.EXE      45928   07-01-93    2:00a
  194.         PATCH.RTP     129654   10-18-93   10:38a
  195.  
  196.  
  197.      Installation Instructions:
  198.  
  199.      TO APPLY THIS PATCH:
  200.      ===================
  201.  
  202.      1)   Delete PATCH.* from the NGM\BIN directory if you have applied
  203.           previous NGM patches.
  204.  
  205.      2)   Copy the files PATCH.EXE and PATCH.RTP to your NGM\BIN subdirectory.
  206.  
  207.      3)   Change directories to your NGM\BIN directory.
  208.  
  209.      4)   Make a backup copy of the following NGMSNADS 1.00b files:
  210.  
  211.           NGMSNADS.NLM   (dated 01-08-93 ;   2697 bytes in size)
  212.           SNADSCON.NLM   (dated 01-11-93 ; 133940 bytes in size)
  213.           SNADSRUN.NLM   (dated 02-09-93 ; 274998 bytes in size)
  214.           SNADUINS.NLM   (dated 01-07-93 ;   2539 bytes in size)
  215.           SNADSCON.HLP   (dated 01-11-93 ;   3943 bytes in size)
  216.  
  217.      If you have previously applied the SNADSU2 patch, your current NGMSNADS
  218.      files will have the following file statistics:
  219.  
  220.           NGMSNADS NLM     2722 08-11-93   4:06p
  221.           SNADSCON NLM   156337 08-11-93   4:00p
  222.           SNADSRUN NLM   288482 09-08-93   5:16p
  223.           SNADUINS NLM     3005 08-03-93   4:04p
  224.           SNADSCON HLP     6686 06-29-93  11:24a
  225.  
  226.      If you have previously applied the SNADSU3 patch, your current NGMSNADS
  227.      files will have the following file statistics:
  228.  
  229.           NGMSNADS NLM     2722 08-11-93   4:06p
  230.           SNADSCON NLM   156337 08-11-93   4:00p
  231.           SNADSRUN NLM   288615 09-22-93   5:55p
  232.           SNADUINS NLM     3005 08-03-93   4:04p
  233.           SNADSCON HLP     6686 06-29-93  11:24a
  234.  
  235.      5)   Run the program PATCH.EXE (with no parameters).
  236.  
  237.      6)   If the patch succeeds, delete PATCH.EXE and PATCH.RTP.
  238.  
  239.      The resulting NGMSNADS files will have the following file statistics:
  240.  
  241.           NGMSNADS NLM     2722 08-11-93   4:06p
  242.           SNADSCON NLM   156337 08-11-93   4:00p
  243.           SNADSRUN NLM   288727 10-14-93  12:27p
  244.           SNADUINS NLM     3005 08-03-93   4:04p
  245.           SNADSCON HLP     6686 06-29-93  11:24a
  246.  
  247.      7)   If the patch fails, restore the files backed up in Step 4 and
  248.           contact Novell Technical Support for additional help.
  249.  
  250.  
  251.      Solution Specifics:
  252.  
  253.      Features
  254.      ========
  255.  
  256.      The SNADS protocol module provides the following features:
  257.  
  258.           *    Transfers messages between NetWare Global MHS and SNADS
  259.                endpoints using an existing             SNA network.
  260.  
  261.           *    Provides support for the SNA communications protocols.
  262.  
  263.           *    Supports connections via direct token ring, ethernet, or SDLC
  264.                to an SNA wide area network.  (Note that the connection
  265.                parameters for ethernet are the same as the connection
  266.                parameters for token ring).
  267.  
  268.           *    Supports one or more LU6.2 sessions and up to two PU2.0 or 2.1
  269.                connections.
  270.  
  271.           *    Supports automatic directory synchronization between DISOSS and
  272.                NetWare Global MHS.
  273.  
  274.           *    Supports SMF extended addresses.
  275.  
  276.           *    Allows you to choose whether header information (such as To:,
  277.                From:, Subject:, cc:, and Date:)  will be included in messages
  278.                sent to SNADS.
  279.  
  280.           *    Allows you to choose whether original messages will be included
  281.                in messages replied to by       SNADS users.
  282.  
  283.  
  284.      Extended Address Support
  285.      ========================
  286.  
  287.      A new feature in SNADS for NetWare Global MHS allows SNADS users to
  288.      include SMF extended addresses in messages sent to NetWare Global MHS.
  289.      Because SNADS users can now include address extensions in their messages,
  290.      the Global MHS server administrator no longer needs to define users with
  291.      extended addresses in the SNADS Auto-Registration Table.
  292.  
  293.      Some environments, such as fax and X.400, require special address
  294.      information. To support these environments, the SMF protocol contains an
  295.      extended address field. For example, to send a message to Sharon
  296.      Carstairs through a fax gateway, a NetWare Global MHS user would address
  297.      the message to Sharon Carstairs@FaxGate {Fax:1-555-1234/Sharon
  298.      Carstairs}.
  299.  
  300.      However, SNADS does not support extended addresses. To enable SNADS users
  301.      to send to these environments, the SNADS protocol module allows SNADS
  302.      users to include extended addresses in their messages.
  303.  
  304.      SNADS users can enter extended addresses in one (and only one) of the
  305.      following three locations: at the beginning of the message; in the
  306.      subject; or at the beginning of the document. The SNADS protocol module
  307.      scans these three locations in the order in which they are listed. If it
  308.      finds an extended address in one of these locations, it will ignore any
  309.      extended addresses in the others.
  310.  
  311.      An extended address definition begins with two open angle brackets (<<)
  312.      and ends with two closed angle brackets (>>). Between the beginning and
  313.      ending markers are one or more address extensions, separated by one or
  314.      more spaces. Thus, the syntax of the extended address definition is as
  315.      follows:
  316.  
  317.           <<extension definition(s)>>
  318.  
  319.      Each extension definition has one of the following formats:
  320.  
  321.           dgn.den={extended address}
  322.  
  323.           dgn.den=(extended address)
  324.  
  325.           dgn.den="extended address"
  326.  
  327.      where dgn.den is a recipient specified in the address (TO and CC) fields.
  328.      The extended address can be enclosed in braces, parentheses, or double
  329.      quotation marks.
  330.  
  331.      If a message has only one recipient, the dgn.den= can be omitted from the
  332.      extended address definition.
  333.  
  334.      For example,  Pam Pratt is a SNADS user who wants to send a message to
  335.      Sharon Carstairs. Messages for Sharon are routed through NetWare Global
  336.      MHS to a fax gateway. Pam creates the following message:
  337.  
  338.           TO:       FAXGATE.SCARSTAI
  339.  
  340.           SUBJECT:  <<{Fax:1-555-1234/Sharon Carstairs}>>
  341.  
  342.      Because the message is addressed to only one user, Pam does not include
  343.      the dgn.den=.
  344.  
  345.      Consider a second example. Pam Pratt wants to send a message to Sharon
  346.      Carstairs, Jack Smith, a Global MHS user, and Donna White, an X.400 user.
  347.      Messages for Donna are routed through NetWare Global MHS to an X.400
  348.      Gateway.  Pam creates the following message:
  349.  
  350.           TO:      FAXGATE.SCARSTAI
  351.                    NEWYORK.JSMITH
  352.                    X400GATE.DWHITE
  353.  
  354.           SUBJECT: Monthly Update
  355.  
  356.                <<
  357.  
  358.                FAXGATE.SCARSTAI={Fax:1-555-1234/Sharon Carstairs}
  359.  
  360.                X400GATE.DWHITE={X400:C=US;A=Publicmail;P=ABC;O=ABC;G=Donna;S=Wh
  361.                ite}
  362.  
  363.                >>
  364.  
  365.                Sharon and Donna:  The update will be delayed one day.  We will
  366.                be sending it tomorrow.
  367.  
  368.      Because the message is addressed to more than one user, Pam must include
  369.      the dgn.den=.
  370.  
  371.  
  372.      SNADS Protocol Module Training
  373.      ==============================
  374.  
  375.      Self-paced study course #1760, titled Administering SNADS for NetWare
  376.      Global MHS, is available. NetWare Global MHS training course #750
  377.      provides comprehensive instruction in installation, configuration, and
  378.      administration of the NetWare Global MHS software.
  379.  
  380.      For more information about either of these training courses, call (800)
  381.      233-3382 or (801) 429-5508, or contact your local Novell authorized
  382.      education center.
  383.  
  384.      Contacting Novell Messaging Technical Support
  385.  
  386.      Should you need technical support for NetWare Global MHS, contact your
  387.      Novell reseller, or Novell at (800) NETWARE or (801) 429-5588.
  388.  
  389.             ****************************************************
  390.                      DISCLAIMER
  391.  
  392.      Novell, Inc. makes no representations or warranties with respect to this
  393.      software patch, and specifically disclaims any express or implied
  394.      warranties of merchantability, title, or fitness for a particular
  395.      purpose.
  396.  
  397.      Distribution of this patch is forbidden without the express written
  398.      consent of Novell, Inc.  Novell reserves the right to discontinue
  399.      distribution of this software patch.
  400.  
  401.      Novell will not be responsible for any data loss that may result from
  402.      implementing this patch.  Novell strongly recommends a backup be made
  403.      before any patch is applied.   Technical support for this patch is
  404.      provided at the discretion of Novell.
  405.  
  406.             ****************************************************
  407.